
 
 F u n c t i o n :   $ A ( o b j e c t P a r e n t D C ,   a r r a y O f K e y V a l u e M a p s T o G e n e r a t e ,   o b j e c t K e y V a l u e M a p O v e r r i d e s ,   b o o l D e l a y T i l D o c u m e n t L o a d e d ,   b o o l D i s a b l e A s y n c ) 
 
 
 
 D e s c r i p t i o n :   g e n e r a t e s   a   c o l l e c t i o n   o f   n e w   D C   o b j e c t s . 
 
 
 
 R e t u r n s :   D C   O b j e c t s   A r r a y . 
 
 
 
 N o t e :   W h e n   o b j e c t P a r e n t D C   i s   s e t   w i t h   a   p r e e x i s t i n g   D C   o b j e c t ,   t h e   p a r e n t   c h i l d   p r o p e r t y   m a p p i n g s   s p e c i f i e d   w i t h i n   t h e   D C   A P I   w i l l   a u t o m a t i c a l l y   b e   p o p u l a t e d .   I f   o m i t t e d ,   t h e   n e w   D C   o b j e c t s   w i l l   b e   c o n s i d e r e d   t h e   p a r e n t s   f o r   t h a t   c o l l e c t i o n .   T h e   a r r a y K e y V a l u e M a p   m u s t   c o n s i s t   o f   a n   a r r a y   o f   D C   o b j e c t   d e c l a r a t i o n s .   U n l i k e   t h e   t o D C ( )   f u n c t i o n ,   w h i c h   w i l l   g e n e r a t e   a n   I D   a u t o m a t i c a l l y   i f   o m i t t e d ,   D C   o b j e c t   d e c l a r a t i o n s   p a s s e d   t o   $ A ( )   m u s t   i n c l u d e   a   u n i q u e   I D   f o r   e v e r y   D C   o b j e c t   i n s t a n c e .   A f t e r   w h i c h ,   t h e   g e t D C ( )   f u n c t i o n   c a n   b e   u s e d   t o   r e t r i e v e   t h e   D C   o b j e c t   w i t h   t h e   s p e c i f i e d   I D .   S h a r e d   p r o p e r t i e s   a n d   m e t h o d s   c a n   b e   s e t   w i t h i n   o b j e c t K e y V a l u e M a p O v e r r i d e s ,   w h i c h   w i l l   b e   m e r g e d   i n t o   a l l   D C   o b j e c t s   w i t h i n   t h e   c o l l e c t i o n ,   b u t   o n l y   i f   t h e   p r o p e r t y   o r   m e t h o d   i s   n o t   a l r e a d y   s p e c i f i e d   w i t h i n   t h e   i n d i v i d u a l   d e c l a r a t i o n   a r r a y .   W h e n   D C . a l l o w C a s c a d e   i s   t r u e ,   l i f e c y c l e   m e t h o d s   s u c h   a s   b e f o r e R e n d e r ,   a f t e r R e n d e r ,   a n d   s o   o n   a s   d o c u m e n t e d   w i t h i n   t h e   D C   A P I ,   w i l l   b e   e x i c u t e d   o n   t h e   i n d i v i d u a l   d e c l a r a t i o n s ,   a s   w e l l   a s   o n   t h e   s h a r e d   o v e r r i d e s   d e c l a r a t i o n   i n   s u c c e s s i o n   i f   p r e s e n t .   A l l   D C   o b j e c t s   g e n e r a t e d   w i t h i n   t h e   s a m e   a r r a y   a r e   r e g i s t e r e d   a s   s i b l i n g s . 
 
 
 
 E x a m p l e : 
 
 
 
 / /   S y n t a x   f o r   c r e a t i n g   a   b a s i c   c o l l e c t i o n   o f   a s s o c i a t e d   D C   o b j e c t s . 
 
 v a r   d c O b j e c t s A r r a y   =   $ A ( [ 
 
     { 
 
         i d :   " U n i q u e I d 1 " 
 
     } , 
 
     { 
 
         i d :   " U n i q u e I d 2 " 
 
     } , 
 
     { 
 
         i d :   " U n i q u e I d 3 " 
 
     } 
 
 ] ) ; 
 
 
 
 / /   S y n t a x   f o r   c r e a t i n g   a   b a s i c   c o l l e c t i o n   o f   a s s o c i a t e d   D C   o b j e c t s ,   p l u s   s h a r e d   o v e r r i d e s . 
 
 v a r   d c O b j e c t s A r r a y   =   $ A ( [ 
 
     { 
 
         i d :   " U n i q u e I d 1 " 
 
     } , 
 
     { 
 
         i d :   " U n i q u e I d 2 " 
 
     } , 
 
     { 
 
         i d :   " U n i q u e I d 3 " 
 
     } 
 
 ] , 
 
 { 
 
     / /   S h a r e d   D C   A P I   p r o p e r t i e s   a n d   m e t h o d s   t o   m e r g e   i f   n o t   a l r e a d y   d e c l a r e d   i n d i v i d u a l l y . 
 
 } ) ; 
 
 
 
 